home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 June: Reference Library / Dev.CD Jun 99 RL Disk 1.toast / Technical Documentation / Develop / develop Issue 26 / develop Issue 26 code / Wide (64 bit) Library / !WideLib ReadMe First next >
Encoding:
Text File  |  1996-08-07  |  4.5 KB  |  69 lines  |  [TEXT/ttxt]
  1. Int64Lib ReadMe First
  2. ====================
  3.  
  4. 07 Aug 96 - Terry Teague - first external release
  5.  
  6. The first library supported is the WideLib code for both 68K and PPC, created from code supplied in _develop_ magazine, issue #26.
  7.  
  8. This library has been compiled under the following development systems:
  9. - THINK C 68K 7.0.5
  10. - Symantec C for PPC 8.0 Rel. 4
  11. - CodeWarrior 9 (68K and PPC)
  12. - MPW 3.3.1 (MPWC 68K and PPCC PPC)
  13. - MPW 3.4.1 (SC 68K and MrC PPC)
  14.     
  15. Applications need to include Wide.h in their source and link with the appropriate libraries. The GX version of the WideLib as described in _develop_ is currently NOT supported.
  16.  
  17. Naming Convention :
  18.  
  19. Development Environment          68K                                PPC
  20. ----------------------------------------------------------------------------
  21. THINK C 7.0.5 (Project)              WideLib.68K.π              -
  22. THINK C 7.0.5 (A4 Project)         WideLib.68K-A4.π        -
  23. THINK C 7.0.5 (Appl Project)      WideTest.68K.π            -
  24. THINK C 7.0.5 (Lib)                     Wide.68K.lib                 -
  25. THINK C 7.0.5 (A4 Lib)                Wide.68K-A4.lib           -
  26. THINK C 7.0.5 (Appl)                   WideTest.68K               -
  27. Symantec 8.0.4 (Project)            -                                   WideLib.PPC.π
  28. Symantec 8.0.4 (Appl Project)    -                                   WideTest.PPC.π
  29. Symantec 8.0.4 (Lib)                   -                                   Wide.PPC.lib
  30. Symantec 8.0.4 (Appl)                 -                                   WideTest.PPC
  31. CodeWarrior CW9 (Project)        WideLib.68K.µ               WideLib.PPC.µ
  32. CodeWarrior CW9 (A4 Project)   WideLib.68K-A4.µ         -
  33. CodeWarrior CW9 (Appl Project)WideTest.68K.µ             WideTest.PPC.µ
  34. CodeWarrior CW9 (Lib)               Wide.68K.lib.mw            Wide.PPC.lib.mw
  35. CodeWarrior CW9 (A4 Lib)          Wide.68K-A4.lib.mw      -
  36. CodeWarrior CW9 (Appl)             WideTest.68K.mw          WideTest.PPC.mw
  37. MPW 3.3.1 (Lib)                           Wide.68K.lib                  Wide.PPC.xcoff
  38. MPW 3.3.1 (Appl)                         TestWide.68K                TestWide.PPC
  39. MPW 3.4.1 (Lib)                           Wide.68K.lib.SC             Wide.PPC.xcoff.MrC
  40. MPW 3.4.1 (Appl)                         TestWide.68K.SC           TestWide.PPC.MrC
  41.  
  42.  
  43. The source code is compatible with pre-Universal Headers, Universal Headers v1.0, Universal Headers v2.x, and Universal Headers v3.0 on the upcoming Mac OS 8 DR1 release.
  44.     
  45. But some versions of these headers don't come with standard ANSI C includes needed for the test application, so you need you copy the ANSI headers, or change CIncludes/PPCCIncludes (for MPW 3.4.1) to something like : 
  46.     
  47. Set CIncludes "Mac OS 8 Interfaces & Libraries:Interfaces:CIncludes:, {CIncludes}"
  48. Set PPCCIncludes "Mac OS 8 Interfaces & Libraries:Interfaces:CIncludes:, {PPCCIncludes}"
  49.  
  50. I was unable to build a SYM file for the Symantec for PPC 8.0 Rel. 4 (it requires use of PPCLink/MakePEF/MakeSYM rather than the internal incremental linker), and I had other strange problems with the Symantec environment such as the PPC library being built incorrectly. MPW has one incompatibility with Universal Headers v2.0 - the SCMBuild script attempts to take care of this, but you will probably have to tweak things manually.
  51.  
  52. To build the THINK/Symantec/CodeWarrior versions, launch the appropriate IDE, open the appropriate project, and either build a library, build an application, or make the project up to date - it should be fairly self-explanatory (note the Options settings for the Symantec projects) - the libraries are output to the "Libs" folder.
  53.  
  54. To build the MPW versions, enter the following in the Worksheet :
  55.  
  56. directory <path-to-Int64Lib-folder> # fill in your own pathname here
  57. SCMBuild -help # will tell you the available options
  58. SCMBuild -WideLib # will build the libraries
  59. SCMBuild -TestWide # will build the test application.
  60.  
  61. By default in the MPW version, symbols are off. To make a SYM/xSYM file, enter the following in the Worksheet :
  62.  
  63. SCMBuild -WideLib -d Sym•PPC=∂'-sym on∂' -d Sym•68K=∂'-sym on∂'
  64. SCMBuild -TestWide -d Sym•PPC=∂'-sym on∂' -d Sym•68K=∂'-sym on∂'
  65. MakeSYM -i :Sources: TestWide.PPC.MrC.xcoff -sym 3.2 # 3.2 is "old", default is 3.4
  66.  
  67. There is a bug in the PPC (and FAT if you run on a Power Macintosh) version of the MPW TestWide application in that the SIOW library used doesn't work right - all you see is a blank window. Hit return 3 times, and Quit - the application may crash (and you can just exit to shell if in MacsBug), but the output you want is sent to a file called "stderr" that is created.
  68.  
  69.